CLEAN GAME LIBRARY
------------------

The Clean Game Library is a library for writing two-dimensional games in
Clean. The library works with a special  Game  type, which contains a
complete game definition. This definition can be found in the module
StdGameDef.

The current implementation is for Windows/DirectX only.

This package contains version 1.2 (release 2, September 2000) of the 
Clean Game Library.


CHANGES

The following changes/fixes were made since the first 1.2 release:

- The function  getBoundMap  was corrected. Before, it always returned
the value -1.

- User defined events, created with the function  createUserGameEvent
were occasionally lost when this function was used within a userevent-
function. This problem has been fixed.

- The implementation for the  collide  event has changed a little:
before, collide events could be lost when changing an object's bounds
from within a collide event function.

- Key codes for the Shift and Ctrl keys were added: GK_SHIFT and
GK_CONTROL.


INSTALLATION

The Clean Game Library depends on the ObjectIO library. Therefore, the
ObjectIO library must be installed in order to use the Game Library.
The following directory structure is recommended for the library:

    Clean\
    Clean\Object IO\Object IO 1.2.1
    Clean\Object IO\StdLib 1.0
    Clean\GameLib
    Clean\Game Examples

With this structure, the example games can be compiled and run by simply
opening the .prj file in CleanIDE and pressing Ctrl-R.

In order to use the game library, DirectX is required. DirectX can be
downloaded from Microsoft: http://www.microsoft.com/directx/. Although
the game library should work with any version of DirectX, getting the
newest version (or at least version 5.0) is highly recommended. 


TILE STUDIO

A special application named Tile Studio is available for creating 
graphics. The output contains code that can be imported directly into
the game Clean source code. Tile Studio is available from:
http://www.cs.kun.nl/is/ts/. A tutorial can be found on this site as
well.


Website:  http://www.cs.kun.nl/is/cgl/
E-mail:   mike.wiering@cs.kun.nl
